home *** CD-ROM | disk | FTP | other *** search
/ Aminet 15 / Aminet 15 - Nov 1996.iso / Aminet / util / misc / Change.lha / Change / Change.dok < prev    next >
Encoding:
Text File  |  1996-09-15  |  8.3 KB  |  198 lines
  1.                     Change Version 2.19 (02.08.96)
  2.  
  3. Dieses Programm dient zum Ändern oder Erkennen verschiedener Zeichenketten
  4. in Dateien. Sie können damit in einem Binär- oder Textfile bestimmte
  5. Zeichenfolgen suchen und diese durch andere ersetzen lassen. Haben Sie zum
  6. Beispiel ein Programm völlig konfiguriert und Sie ändern nachher die Pfade
  7. der Datei, weil Sie sich eine neue Festplatte gekauft haben, so müssen Sie
  8. nicht alles erneuern, sondern Sie lassen nur die Pfad-Zeichenkette suchen
  9. und ersetzen.
  10.  
  11. Es wurde von Dirk Stöcker in MaxonC++ V3.00 programmiert und ist Public
  12. Domain. Ich gebe alle Rechte und damit alle Pflichten an dem Programm auf.
  13. Ich gebe keinerlei Garantie für das ordnungsgemäße Funktionieren des
  14. Programmes.
  15.  
  16. Seit Version 2.0 besitzt Change eine graphische Benutzeroberfläche. Die
  17. Bedienelemente entsprechen den Parametern in der Shell. Zu dieser Ober-
  18. fläche gelangen sie durch einen Doppelklick auf das Icon oder durch einen
  19. parameterlosen Aufruf aus der Shell.
  20. Seit Version 2.3 ist das CLI-Template an den Commodore Standard angepaßt.
  21. Dadurch ergeben sich einige wenige Änderungen zu Vorversionen.
  22.  
  23. Dieses Programm benötigt mindestens OS2.0 (V37).
  24.  
  25. Die Geschichte des Programms steht im Source Code -> source/Change/Change.c
  26.  
  27. Mit dieser Meldung begrüßt Sie das Programm beim Aufruf mit '?'.
  28. -->  Change ?
  29.  
  30. FROM/A,SSTRING/A,TO,RSTRING,FOUND/S,HEX/S,LENGTH/S,NOCHANGE/S,NOSIZE/S,
  31. OVERWRITE/S,PATH/S,POS=POSITION/K:
  32.  
  33. Geben Sie nochmal '?' ein, so kommt eine genauere Erklärung.
  34.  
  35. Mit "Version Change" erhalten Sie die Versionsnummer des Programmes.
  36.  
  37. Parametererklärung:
  38. FROM        ist das schon existierende File aus dem gelesen wird.
  39.         > muß immer angegeben werden.
  40. SSTRING        sind die zu suchenden Zeichen.
  41.                 > muß immer angegeben werden.
  42. TO        ist das File in das geschrieben wird. Es muß noch nicht
  43.                 existieren. Wenn für das Zielfile das Quellfile oder ""
  44.                 angegeben wird, so wird in das Ausgangsfile gespeichert
  45.                 > muß außer bei NOCHANGE immer angegeben werden.
  46. RSTRING        ist der Ersatz für den <source string>.
  47.                 > muß nicht angegeben werden (wenn nicht angegeben, dann
  48.                   leer
  49. FOUND           gibt eine Meldung aus, wenn der SSTRING gefunden wurde
  50.         (z.B. String gefunden bei 32C). Die Zahl ist der hexa-
  51.         dezimale Code der Position.
  52.                 > muß nicht angegeben werden (bei NOCHANGE überflüssig).
  53. HEX             ermöglicht die Eingabe der Zeichenketten in hexadezima-
  54.                 ler Schreibweise. (Manche Zeichen kann man nicht über
  55.                 Tastatur eingeben, z.B. Return, oder werden von der
  56.                 Shell nicht weitergeleitet, z.B. das ';'.
  57.                 > muß nicht angegeben werden.
  58. LENGTH          ändert das Zeichen vor dem Wechsel um die veränderte
  59.                 Länge - bestimmte Programme legen dort die Längeninfor-
  60.                 mation ab (entspricht einem BCPL-String: BSTR).
  61.                 > muß nicht angegeben werden (bei NOCHANGE überflüssig
  62.                   und unnötig, wenn Länge des SSTRING gleich der Länge
  63.                   des RSTRING).
  64. NOCHANGE        Hiermit wird das Ersetzen ausgeschaltet.
  65.                 Die Position wird wie bei FOUND automatisch ausgegeben.
  66.                 Die Parameter TO, LENGTH, FOUND, OVERWRITE, PATH und
  67.                 RSTRING sind überflüssig.
  68.                 > muß nicht angegeben werden.
  69. NOSIZE          schaltet die Groß-/Kleinunterscheidung aus
  70.                 > muß nicht angegeben werden
  71. OVERWRITE       überschreibt die Zeichen hinter dem SSTRING, wenn der
  72.         RSTRING länger ist. Ist er kürzer, so wird mit 0 aufge-
  73.         füllt.
  74.                 > muß nicht angegeben werden (unnötig, wenn Länge des
  75.                 SSTRING gleich der Länge des RSTRING).
  76. PATH            Damit können ganze Pfade ersetzt werden. Wenn die zwei
  77.                 Strings sich in der Länge unterscheiden, so wird
  78.                 ähnlich wie bei OVERWRITE überschrieben oder mit 0 auf-
  79.                 gefüllt, aber erst, wenn das 0-Zeichen erkannt wird.
  80.                 Damit kann man z.B. Pfadangaben in Files ersetzen, die
  81.                 nach den Namen Nullen schreiben. Mit dieser Option bleibt
  82.                 der Pfad zusammen.
  83.                 > bei OVERWRITE und gleichen Längen ausgeschaltet
  84. POS             Abkürzung für POSITION
  85. POSITION        Hinter POSITION muß in hexadezimaler Schreibweise die
  86.                 Position des zu ersetzenden string angegeben werden.
  87.                 Nur an dieser Stelle wird ersetzt. (Bei Eingabe von 0
  88.                 werden alle strings ersetzt. Die Positionen können Sie
  89.                 vorneweg mit dem Parameter NOCHANGE erfahren.
  90.                 > muß nicht angegeben werden (bei NOCHANGE überflüssig)
  91.  
  92. Bei FROM und TO ist der volle Pfad vom aktuellen Verzeichnis oder von
  93. einem Grundverzeichnis aus nötig.
  94.  
  95. Wenn die Schlüsselworte nicht angegeben werden, ist der erste String FROM,
  96. der zweite SSTRING, der dritte TO und der vierte RSTRING.
  97.  
  98. Change kann auch einen String verarbeiten, in dem ein Pattern einhalten ist.
  99. Setzt man bei hexadezimaler Eingabe ein ? ein, so wird an dieser Stelle
  100. jeder Buchstabe akzeptiert.
  101. Bei normaler Eingabe bedeutet \? den Pattern und \\ den \, kommt nach dem \
  102. eine zweistellige HEX-Zahl, so wird \.. in das ASCII-Zeichen der Zahl umge-
  103. wandelt
  104. (sehen Sie bei den Beispielen nach)
  105. Bei hexadezimaler Eingabe werden alle Zeichen ungleich (0..9 a..f A..F ?)
  106. den geforderten ignoriert. Sie können also zum Beispiel Striche einsetzen,
  107. um die Lesbarkeit zu erhöhen.
  108. 123a4b52349f009a entspricht also 123a_4b52_349f_009a oder 
  109. 123a.4b52.349f.009a oder 1-2-3-a-4-b-5-2-3-4-9-f-0-0-9-a.
  110.  
  111. Am Anfang gibt das Programm noch einmal den zu suchenden und den Ersatz-
  112. string aus:
  113. dargestellt werden Zeichen zwischen 20 und 126 und zwischen 161 und 255
  114. Invers dargestellte Zeichen stehen für andere Zeichen
  115. . bedeutet dabei ein nicht darstellbares Zeichen
  116. _ bedeutet einen Pattern
  117.  
  118. Am Ende gibt das Programm einen Status aus:
  119. String wurde ... mal gefunden und ... mal gewechselt
  120.  
  121. Beispiele:
  122. Sie suchen im File SYS:Texte/S den Namen Goethe:
  123. --> Change SYS:Texte/S Goethe NOCHANGE
  124.  
  125. In hexadezimaler Eingabe sieht das so aus:
  126. --> Change SYS:Texte/S 476F6574_6865 NOCHANGE HEX
  127.  
  128. Wollen Sie den Namen in Schiller ändern so müssen Sie noch ein Ziel
  129. (z.B. SYS:Texte/S2) angeben und NOCHANGE entfernen:
  130. --> Change SYS:Texte/S Goethe SYS:Texte/S2 Schiller
  131.  
  132. Mit NOSIZE können Sie auch nach goethe oder GOETHE oder GoEtHe
  133. suchen lassen und FOUND zeigt Ihnen einen Fund an:
  134. --> Change SYS:Texte/S Goethe SYS:Texte/S2 Schiller NOSIZE FOUND
  135.  
  136. Geben Sie vorher den CD-Befehl auf den Pfad ein, so verkürzt sich der
  137. Befehl:
  138. --> CD SYS:Texte
  139.     Change S Goethe S2 Schiller NOSIZE FOUND
  140.  
  141. Wollen Sie zum Bsp. goethe und GoEtHe und GOETHE durch die richtige
  142. Form Goethe ersetzen. Kein Problem:
  143. --> Change S goethe S2 Goethe NOSIZE
  144.  
  145. Soll Goethe nur an einer Stelle ersetzt werden, so nutzen Sie POSITION:
  146. --> Change S goethe S2 Goethe POSITION D3 NOSIZE
  147.  
  148. Alternativ dazu ist:
  149. --> Change S goethe S2 Goethe POS D3 NOSIZE
  150.  
  151. Besitzen die Zeichenketten ein Leerzeichen so nutzen Sie "":
  152. --> Change S "Goethes Geburtshaus" S2 "Schillers Geburtshaus"
  153.  
  154. Sie können den SSTRING auch aus dem Text löschen:
  155. --> Change S "Goethe" S2 ""            oder
  156. --> Change S "Goethe" S2
  157.  
  158. Falls sie alle ähnlichen Wörter ersetzen wollen, wie zum Beispiel
  159. Disc und Disk gegen Diskette, so nutzen Sie einen Pattern:
  160.  
  161. --> Change S Dis\? S2 Diskette
  162.  
  163. oder
  164.  
  165. --> Change S 446973? S2 4469736B_65747465
  166.  
  167. Wollen Sie nach einem \ suchen, so müssen Sie zwei eingeben (also immer
  168. doppelt so viele - bei 20 zu suchenden also 40)
  169.  
  170. --> Change S \\ S2 /            --> das wechselt \ zu /
  171.  
  172. --> Change S \\\\ S2 //         --> das wechselt \\ zu //
  173.  
  174. --> Change S \\? S2 /?          --> das wechselt \? zu /?
  175.  
  176. aber VORSICHT !
  177.  
  178. --> Change S \? S2 /?           --> das wechselt jedes Zeichen zu /?
  179.  
  180. Setzen Sie für SSTRING "" ein, so erscheint eine Fehlermeldung.
  181.  
  182. Mögliche zukünftige Erweiterungen:
  183.  
  184. Pattern * für beliebige Zeichen oder Standard Amiga Pattern, wie #, ~, ().
  185. Lokalisierung und damit auch deutsche Texte (Fehlermeldungen sind ja schon
  186. vom Betriebssystem lokalisiert!)
  187.  
  188. Kommentare, Wünsche, Geld (ist zwar Public Domain, nehme es aber trotzdem),
  189. Grüße, Bugreports und ähnliches an
  190.  
  191. snail-mail:    Dirk Stöcker
  192.         Geschwister-Scholl-Straße 10
  193.         01877 Bischofswerda
  194.         GERMANY
  195. e-mail:        stoecker@rcs.urz.tu-dresden.de
  196.  
  197. Viel Glück mit dem neuen Programm!
  198.